package com.service;

import com.entity.DictionaryEntry;

import java.io.IOException;
import java.util.List;

public interface DictionaryService {

    /**
     * 从线上或本地读取 Excel 文件并更新字典表。
     */
    void updateDictionaryFromExcel() throws IOException;

    /**
     * 从线上 URL 下载 Excel 文件。
     *
     * @return 下载的文件
     * @throws IOException 如果下载失败
     */
//    byte[] downloadOnlineExcel() throws IOException;

    /**
     * 从本地文件系统读取 Excel 文件。
     *
     * @return 本地文件
     * @throws IOException 如果读取失败
     */
    byte[] readLocalExcel() throws IOException;

    /**
     * 解析 Excel 文件并返回字典条目列表。
     *
     * @param file Excel 文件
     * @return 字典条目列表
     * @throws IOException 如果解析失败
     */
    List<DictionaryEntry> parseExcel(byte[] file) throws IOException;

    /**
     * 更新字典表中的数据。
     *
     * @param entries 新的字典条目列表
     */
    void updateDictionaryTable(List<DictionaryEntry> entries);
}